home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DISK / RTVMNU.ARJ / RTVMNU.DOC < prev    next >
Text File  |  1992-04-18  |  18KB  |  436 lines

  1.  
  2.                              RT Systems Documentation 
  3.  
  4. ********************************************************************************
  5. * Version 1.0                        RTVMNU                         April 1992 *
  6. ********************************************************************************
  7.  
  8. System Requirements:
  9.  
  10.     IBM Compatible Computer
  11.     VGA Card/Monitor*
  12.     DOS 3.3 Or Higher
  13.  
  14.     *It may or may not work on a VGA monochrome monitor, you may have
  15.      to adjust the colors.
  16.  
  17. Overview:
  18.  
  19.             This is more than just the average menu program that let's 
  20.     you just run your programs. This menu program allows the user to
  21.     design their own menues and pick their own colors as they go along.
  22.     You also have the capability of mixing your own colors if you so 
  23.     desire (registered version only). When you setup a program to run on 
  24.     the menu system you have the option of separating from the menu system
  25.     to use all of the available memory. You can use a mouse or keyboard or 
  26.     both. You have security capabilities also on the registered version, 
  27.     password,menu and item security. 
  28.             The programs that are included are listed BELOW.
  29.  
  30.                   1. Main menu program
  31.                   2. Menu maintenance programs
  32.  
  33.         To add selections to the menues, see system maintenance menu.
  34.     ( Menu descriptions and Attach programs )
  35.  
  36.  
  37. ********************************************************************************
  38. *                             Selecting Menu Items                             *
  39. ********************************************************************************
  40.  
  41.         You'll notice when you come into the menu system their will 
  42.     be a box around one of the items, normally the top left hand item.
  43.  
  44. Keyboard:
  45.  
  46.         Use up/down/left or right arrows, page up or page down or
  47.     press the alpha key that corresponds to the first character of the
  48.     item. Press the 'ENTER' key when you have selected the correct item.
  49.  
  50. Mouse:
  51.  
  52.         Click the right button on the mouse on the item description
  53.     of the item you want, this will put a box around the item. Click 
  54.     the right button on the mouse on the item description when you have
  55.     the correct item selected.
  56.  
  57.  
  58.  
  59.  
  60.                              RT Systems Documentation 
  61.  
  62. ********************************************************************************
  63. * Version 1.0                        RTVMNU                         April 1992 *
  64. ********************************************************************************
  65. *                        Selecting Menu Items - continued                      *
  66. ********************************************************************************
  67.  
  68.  
  69.         After you run the program you will return to the menu you
  70.     selected the item from if you didn't disconnect from the menu system,
  71.     otherwise you will return to the main menu.
  72.  
  73.  
  74. ********************************************************************************
  75. *                          Terminating Menu System                             *
  76. ********************************************************************************
  77.  
  78.         To terminate the menu system, select the corresponding item
  79.     on the menu or press the ESC key. 
  80.  
  81.  
  82. ********************************************************************************
  83. *                             Work In DOS Mode                               *
  84. ********************************************************************************
  85.  
  86.         This is a DOS shell that is exactly like being at the command
  87.     line entering commands. You can run anything here that memory will
  88.     allow. When you want to go back to the menu system, just type 'EXIT'.
  89.  
  90.  
  91. ********************************************************************************
  92. *                          System Maintenance Menu                           *
  93. ********************************************************************************
  94.  
  95. ********************************************************************************
  96. *                           Design Menues/Colors                             *
  97. ********************************************************************************
  98.  
  99.  
  100.         This program is a fairly technical program, but once we
  101.     understand the makeup of the screen it takes some of the mystery
  102.     out of it. So let's try and define some of the terms that we will 
  103.     be using.
  104.  
  105. VGA Screen:
  106.     
  107.         The VGA screen in the normal graphics mode has 80 columns
  108.     across the screen and 30 rows from the top to the bottom of the
  109.     screen. We can refer to row one, column one as a cursor position.
  110.     
  111.         The VGA screen in the nornal graphics mode has 640 pixels
  112.     across the screen and 480 pixels from the top to the bottom of the
  113.     screen. A pixel is a graphic dot which is used to make graphic lines,
  114.     characters, rectangles, etc. If we use simple mathematics, we find
  115.     that each column is eight pixels wide and that each row is sixteen
  116.     pixels high. 
  117.  
  118.         Now keep in mind, when designing the menues we will be
  119.     working with pixel positions only, not row/column positions.
  120.  
  121.     
  122.  
  123.                              RT Systems Documentation 
  124.  
  125. ********************************************************************************
  126. * Version 1.0                        RTVMNU                         April 1992 *
  127. ********************************************************************************
  128. *                         Design Menues/Colors - continued                     *
  129. ********************************************************************************
  130.  
  131.  
  132.          After selecting from the menu, the program will ask for the
  133.     number of the menu you want to add/change definitions for. Enter the
  134.     menu number.
  135.  
  136.         Then you can enter/change the menu title or press the enter
  137.     if ok as is.
  138.  
  139.         Here are the different coordinates for each line of the
  140.     menu definition.
  141.  
  142.         1. ## = menu definition line number - this will be prompted
  143.            automatically by the program or you can enter a number.
  144.  
  145.         2. Color = A number between 0 and 15, the colors are defined
  146.            at the bottom of the screen.
  147.  
  148.         3. Type = Box/rectange type.
  149.             a. 1 = Filled box/rectangle.
  150.             b. 2 = Border.
  151.  
  152.         4. Code = Whether this box/rectangle is outside or inside of
  153.            the main menu box/rectangle.
  154.             a. 1 = Outside the main menu box/rectangle.
  155.             b. 2 = Main menu box/rectangle (can be only one)
  156.             c. 3 = Inside of main menu box/rectangle.
  157.  
  158.         5. U L Col = Upper left corner starting pixel column position.
  159.             Possibilities are 0 - 639.
  160.  
  161.         6. U L Row = Upper left corner starting pixel row position.
  162.             Possibilities are 0 - 479.
  163.  
  164.         7. L R Col = Lower right corner ending pixel column position.
  165.             Possibilities are 0 - 639.
  166.  
  167.         8. L R Row = Lower right corner ending pixel row position.
  168.             Possibilities are 0 - 479.
  169.  
  170.         9. Times = This is only used in conjuction with type 2 (border)
  171.             above. This describes how many pixels wide you want 
  172.             the border. Possibilities are 1 to nn.  
  173.  
  174.         One thing to remember is that you start designing from the
  175.     outside of the screen to the inside.
  176.  
  177.         If the field is ok as it is, just press the 'ENTER' key.
  178.  
  179.         Also when entering the above fields, when you fill up the 
  180.     field it automatically goes to the next field. Press the ESC key
  181.     to backup to the previous field.
  182.  
  183.  
  184.  
  185.                              RT Systems Documentation 
  186.  
  187. ********************************************************************************
  188. * Version 1.0                        RTVMNU                         April 1992 *
  189. ********************************************************************************
  190. *                         Design Menues/Colors - continued                     *
  191. ********************************************************************************
  192.  
  193.  
  194.  
  195.         Here is how the user main menu would look if you brought it
  196.     up on the screen in this program.
  197.     
  198.          ## Color Type Code  U L Col  U L Row  L R Col  L R Row  Times    
  199.  
  200.      01  00    1    1      000      000      639      479      00
  201.      02  07    1    1      007      007      632      472      00
  202.      03  00    1    1      014      014      625      465      00
  203.      04  00    1    2      099      099      538      378      00
  204.      05  07    2    3      099      099      538      378      02
  205.      06  14    2    3      112      112      316      367      01
  206.      07  14    2    3      324      112      527      367      01
  207.  
  208.         Now using this documentation as a guide, bring up the user
  209.     main menu and try to connect the screen with the coordinates. Don't
  210.     let line #04 confuse you, it could be taken out and it wouldn't have
  211.     any effect to the menu. To delete a line from the definition, enter
  212.     a numeric zero in 'Code'.
  213.  
  214.         When you have finished defining your menu or if you want to
  215.     see how it looks so far, press the ESC key at '##'. ( Menu Definition
  216.     Line Number ) 
  217.  
  218.         If you only only want to change the colors on the screen,
  219.     change the color to the color you want and enter thru the rest of
  220.     the fields.
  221.  
  222.         If you press the ESC key at '##', the program will ask for the 
  223.     text and backgound colors you want to use. Normally the background  
  224.     color is already there, if not enter the color you used for 'Code' 
  225.     number 2. (Main Menu Box/Rectangle) The text colors are as follows:
  226.  
  227.         1. Normal text color.
  228.         2. Highlighted text color.
  229.         3. Window Color (menu selection box) 
  230.  
  231.         Until you get the hang of this I strongly suggest you 
  232.     practice perhaps on the last menu, menu number 25. Also, you might
  233.     backup/copy the file named 'RTWMNU.RTW' to a diskette or another
  234.     directory. PLEASE don't practice on the already established menues,
  235.     THANK YOU !!!.
  236.  
  237.  
  238.                              RT Systems Documentation 
  239.  
  240. ********************************************************************************
  241. * Version 1.0                        RTVMNU                         April 1992 *
  242. ********************************************************************************
  243. ********************************************************************************
  244. *                           Menu Descriptions                                *
  245. ********************************************************************************
  246.  
  247.  
  248.          After selecting from the menu, the first screen will ask you 
  249.     for the number of the menu you want to add/change descriptions on.
  250.  
  251.         Enter the menu number that you want to add\change the menu
  252.     item descriptions on or press the 'ESC' key to terminate the program.
  253.  
  254.         The program will ask you if want any headings on this menu.
  255.     Headings are classified as anything other than a menu item description.
  256.     Enter 'Y' for yes or 'N' for no.
  257.  
  258.         Whether you are working with menu headings or with item
  259.     descriptions the process is the same.
  260.  
  261.         Menu headings can go any place on the screen. Menu item
  262.     descriptions go inside the main menu box. When entering menu headings,
  263.     remember that the background color of the heading is that of the main 
  264.     menu box. Therefore when you add a menu heading outside the main box 
  265.     the background for that heading will be the color of the main menu box.
  266.     
  267.  
  268.         When entering menu item descriptions on a given section of
  269.     the menu, you should start them all in the same lefthand position in
  270.     each given section.
  271.  
  272.         When you start the cursor will be in the middle of the screen.
  273.     Use the left/right/up/down arrows to position the cursor where you 
  274.     want the description to start. Once you get to the starting point,
  275.     press the 'F1' key to tell the program you want to start entering the
  276.     description. 
  277.  
  278.         Enter the description that you want to use and press the 
  279.     'ENTER' key. The program will now ask for the text color you want to 
  280.     use for this description, enter the text color and press the 'ENTER'
  281.     key.
  282.         The cursor will be repositioned in the middle of the screen.
  283.     Press the ESC key to terminate the program or enter another 
  284.     description.
  285.  
  286.         To delete a description from the screen, position the cursor
  287.     at the beginning of the description and press the 'F2" key.
  288.  
  289.         Once you have some item descriptions established on the
  290.     screen, you can try the HOME/END keys to see what they do.
  291.     
  292.  
  293.  
  294.                              RT Systems Documentation 
  295.  
  296. ********************************************************************************
  297. * Version 1.0                        RTVMNU                         April 1992 *
  298. ********************************************************************************
  299. ********************************************************************************
  300. *                               Attach Programs                              *
  301. ********************************************************************************
  302.  
  303.  
  304.         After You entered a menu item description on the menu you
  305.     must tell the program what action is to be taken for that description.
  306.  
  307.          After selecting from the menu, the first screen will ask you 
  308.     for the number of the menu you want to add/change actions on.
  309.  
  310.         Enter the menu number that you want to add\change the actions
  311.     on or press the 'ESC' key to terminate the program.
  312.  
  313.         You'll notice when you come into the program there will 
  314.     be a box around one of the items, normally the top left hand item.
  315.  
  316.  
  317.     To select a item description to assign a action to:
  318.  
  319. Keyboard:
  320.  
  321.         Use up/down/left or right arrows, page up or page down or
  322.     press the alpha key that corresponds to the first character of the
  323.     item. Press the 'ENTER' key when you have selected the correct item.
  324.  
  325. Mouse:
  326.  
  327.         Click the right button on the mouse on the item description
  328.     of the item you want, this will put a box around the item. Click 
  329.     the right button on the mouse on the item description when you have
  330.     the correct item selected.
  331.  
  332.         After you have selected the item description you want to add
  333.     a action to, the program will ask for the action to be taken.
  334.  
  335.     Here are the valid entries for the actions:
  336.  
  337.     1. To go to another menu - Enter 'MENUnn" - nn represents 01 thru 25.
  338.  
  339.     2. To terminate menu system - Enter 'EXIT'.
  340.  
  341.     3. To enter a backup command - BACKUP command - command being any
  342.        valid DOS backup command.
  343.  
  344.     4. To enter a restore command - RESTORE command - command being any
  345.        valid DOS restore command.
  346.  
  347.     5. To enter a program/bat file name - If the directory that the
  348.        program/bat file is in is included in the 'PATH' statement and is 
  349.        on the current drive, then just enter the program/bat file name.
  350.        If the directory is not in the 'PATH' statement or not on the
  351.        current drive then include the full path name such as C:\DOS\ABC.BAT
  352.        or D:\GAMES\ABC.EXE.
  353.  
  354.         Use program names whenever possible, sometimes the contents
  355.     of a bat file will prevent you from returning to the menu system. 
  356.  
  357.                              RT Systems Documentation 
  358.  
  359. ********************************************************************************
  360. * Version 1.0                        RTVMNU                         April 1992 *
  361. ********************************************************************************
  362. *                           Attach Programs - continued                       *
  363. ********************************************************************************
  364.  
  365.  
  366.  
  367.         After entering the action to be taken the following message
  368.     will appear on the screen:
  369.  
  370.     How To Run ? - D = Don't Separate From Menu , S = Separate From Menu
  371.  
  372.         Choose 'D' if the program is fairly small and doesn't require
  373.     alot of memory otherwise choose 'S'. In either case when the progam
  374.     finishes it will return to the menu system.
  375.  
  376.         Now it will ask for parameters to be passed to the program
  377.     to be executed if you selected 's' above. Enter any valid parameters 
  378.     or just press the 'ENTER' key for none.
  379.  
  380.         If the security is active on the menu system the following
  381.     message will appear on the screen:
  382.  
  383.             Enter Security Level For This Program  ( 0 - 9 )
  384.  
  385.         The lowest security level is 0 and the highest is 9. 
  386.  
  387.         Enter a security level and press the 'ENTER' key.
  388.  
  389.         Once you have attached a action to a item description you can
  390.     run it off the menu.
  391.  
  392.         Press the 'ESC' key to terminate the program.
  393.  
  394.  
  395. ********************************************************************************
  396. *                            Print Menu Information                          *
  397. ********************************************************************************
  398.  
  399.  
  400.          After selecting from the menu, the program will ask for the
  401.     number of the menu you want to print the definitions for. Enter the
  402.     menu number.
  403.  
  404.         Press the 'ESC' key to terminate the program.
  405.  
  406.         The program will print a detailed listing of all the
  407.     definitions for the selected menu/screen.
  408.  
  409.  
  410.  
  411.  
  412.                              RT Systems Documentation 
  413.  
  414. ********************************************************************************
  415. * Version 1.0                        RTVMNU                         April 1992 *
  416. ********************************************************************************
  417.  
  418.  
  419.  
  420. Send Correspondece To The Attention Of Roger A Tess
  421.  
  422. Send Correspondence To:         RT Systems
  423.                 P. O. Box 33368
  424. Phone:  (612) 786-2870          Coon Rapids,Mn 55433-0368
  425.  
  426. To Order Software:
  427.         
  428.     Print The Order Form By Typing 'COPY RTVMNU.ORD PRN:' At The DOS
  429.     Prompt In The Directory Where You Copied The Software.
  430.  
  431.         Fill Out The Order Form
  432.  
  433.         Send Check or Money Order And Order Form To RT Systems
  434.  
  435.         
  436. THANK YOU FOR TRYING SOFTWARE FROM RT SYSTEMS !!!